Event File Structure
Each Event File consists of seven primary fields:
| Field | Description |
|---|---|
| EID | User-defined Event Identifier. |
| Type | Specifies the object type that will be modified. |
| DUID | Identifies the object affected by the Event. |
| StartTime | Date and time when the Event becomes active. |
| EndTime | Date and time when the Event expires. |
| Property | Defines which attribute of the object will be modified. |
| Capacity | Value assigned to the selected Property. |
- Fields
EID
The Event Identifier (EID) is a user-defined identifier that uniquely distinguishes each Event.
Examples:
EV001COAL_OUTAGEVISLUZ_LIMIT
Type
The Type field specifies which system object will be modified. Supported object types include:
| Type | Description |
|---|---|
| Pool | Entire electricity market. |
| Region | Market region. |
| Link | Transmission interconnection. |
| Site | Individual generating site. |
| Sites | Multiple sites based on Group classification. |
| SUnit | Supply Unit. |
| DUnit | Demand Unit. |
| Storage | Energy Storage System. |
DUID
The DUID (Dispatchable Unit Identifier) identifies the object that will receive the Event. The required value depends on the selected Type:
| Type | Required DUID |
|---|---|
| Pool | WESM |
| Region | CLUZ, CVIS, or CMIN |
| Link | VISLUZ1 or MINVIS1 |
| Site | Specific Site ID |
| Sites | BATTERY, BIO, CCGT, COAL, DIESEL, DISPDEM, GEO, HYDRO, MR_ALL, OCGT, PUMP, ROR, SOLAR, STGAS, or WIND |
| SUnit / DUnit | Specific Unit ID |
| Storage | Specific Storage ID |
When using Type = Sites, the DUID refers to the Group classification, allowing the Event to be applied to every Site belonging to that Group. The actual group IDs depend on the SysWESM database — use the Object ID dropdown in Event Builder to see available groups.
StartTime
Specifies the exact date and time when the Event becomes active.
Event Builder writes times in 24-hour format: MM/DD/YYYY HH:MM (for example, 11/25/2025 02:50). The engine also accepts AM/PM format (11/25/2025 2:50:00 AM) and ISO format (2026-03-09 13:00:00).
EndTime
Specifies the exact date and time when the Event ends. Once the EndTime has been reached, Dashboard automatically restores the original database values.
Property
Specifies which attribute of the selected object will be modified. Available properties depend on the selected object Type. See Property Definitions by Object Type below.
Capacity
The Capacity field contains the numerical value applied to the selected Property. Its meaning depends on the Property being modified.